home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1994 November: Tool Chest / Dev.CD Nov 94.toast / Apple II / Essentials / Essentials.sea / File.Type.Notes / FTN.B5.XXXX < prev    next >
Encoding:
Text File  |  1993-06-15  |  3.8 KB  |  78 lines  |  [TEXT/GEOL]
  1. Apple II
  2. File Type Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6. File Type:       $B5 (181)
  7. Auxiliary Type:  All
  8.  
  9. Full Name:       ProDOS 16 or GS/OS Shell application file
  10. Short Name:      GS/OS Shell application
  11.  
  12. Revised by:      Dave Lyons                                          May 1992
  13. Written by:      Dave Lyons & Matt Deatherage                  September 1989
  14.  
  15. Files of this type and auxiliary type contain application programs intended
  16. for use within a shell environment for the Apple IIgs.
  17.  
  18. CHANGES SINCE DECEMBER 1991:  Broadened the definition auxiliary type bit 1 to
  19. mean the application can handle getting control with the Super Hi-Res screen
  20. on.
  21. _____________________________________________________________________________
  22.  
  23. Files of type $B5 contain GS/OS shell application programs.  These files
  24. contain program code in Object Module Format (OMF) that is loaded by the
  25. System Loader or ExpressLoad at an address and is then executed under the
  26. control of a command shell (such as APW, for example).
  27.  
  28. The shell may provide extra services to a shell application that are not
  29. available to normal GS/OS applications (files of type $B3).  A shell
  30. application can identify which shell it is running under by examining the
  31. shell identifier.
  32.  
  33. Information about the shell identifier and other shell application environment
  34. issues may be found in GS/OS Reference and APW Reference, where the shell
  35. application environment is completely documented.  OMF is documented in those
  36. manuals as well.  All developers creating files of type $B5 should be familiar
  37. with this material.
  38.  
  39. The auxiliary type for $B5 files is now defined to indicate properties of the
  40. program contained within the file.  Other parts of the system may use this
  41. information to properly control the environment for the program:
  42.  
  43.      bits 31-16        reserved--must be 0
  44.      bits 15-8         signature byte.  $DB means bits 7-0 are valid
  45.      bits 7-3          reserved--must be 0
  46.      bit 2             Message Aware:
  47.                        1 = uses Message Center message #1
  48.                        0 = ignores Message Center message #1
  49.      bit 1             Desktop Application:
  50.                        1 = application can handle the Super Hi-Res
  51.                            screen already being on when it first gets
  52.                            control, so the system can provide a smooth
  53.                            visual transition into the application
  54.                        0 = application is not prepared for the Super
  55.                            Hi-Res screen to be on
  56.      bit 0             GS/OS Aware:
  57.                        1 = uses long prefixes (for example, prefix 9
  58.                            instead of prefix 1)
  59.                        0 = uses short prefixes (less than 63
  60.                            characters)
  61.  
  62.    NOTE: If a Shell Application has the Desktop Application bit
  63.          set, it should be prepared to get control with either the
  64.          text or the Super Hi-Res screen visible.  For example, if
  65.          some error prevents the application from using the
  66.          desktop tools, it may be necessary to make the QuickDraw
  67.          II call GrafOff before the user can read error messages
  68.          displayed on the text screen (it's OK to call GrafOff
  69.          even if QuickDraw II is not active).
  70.  
  71.          If a Shell Application does not have the Desktop
  72.          Application bit set (or does not even have a $DBxx
  73.          auxiliary type), the system software reserves the right
  74.          to force the text screen to be visible if QuickDraw II is
  75.          not started.  Do not assume that a Quit call from one
  76.          application to another (with QuickDraw II not started)
  77.          will leave the Super Hi-Res screen visible.
  78.